home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / relock20.zip / RELOCK.DOC < prev    next >
Text File  |  1992-07-21  |  6KB  |  129 lines
  1. RELOCK V2.0 by Tim Pearson
  2.  
  3. DISCLAIMER
  4. ----------
  5.    This program is not in the public domain.  It is provided "as is" with
  6. no warranty of any kind, including implied warranties of merchantibility
  7. or fitness for a particular purpose.  By using this program, you argree to
  8. accept sole responsibility for any damage that may result from said use.
  9.  
  10. What is RELOCK?
  11. ---------------
  12.    With the advent of the new 16.8Kbps HST's and new high performance UART's
  13. like the 16550, serial communications speed has outstripped the ability of
  14. many formerly well behaved BBS systems and BBS doors to handle the higher
  15. speeds.  However, many FidoNet(tm) compatible front end mailers (D'Bridge is
  16. one noteable example) are perfectly capable of taking advantage of higher
  17. serial port to modem locked rates.
  18.  
  19.    RELOCK is an attempt to give you the best possible throughput with your
  20. mailer while allowing you to slow things down from "warp speed" when your
  21. mailer passes a caller off to your BBS software.
  22.  
  23.    RELOCK has been tested with X00, D'Bridge, QuickBBS, and a USR 16.8 dual
  24. standard modem on an 80486 33mhz machine running under DesqView.
  25.  
  26. RELOCK Operational Overview
  27. ---------------------------
  28.    RELOCK, when provided with the proper command line parameters, will:
  29.  
  30.         1.  Open the specified port, locked at the specified initial rate.
  31.         2.  Wait for all pending output to clear the output buffer.
  32.         3.  Send the modem escape sequence "+++" to place the modem in
  33.             command mode while still on line. (see HST DIP switch setting
  34.             below).
  35.         4.  Switch the fossil to the new bps rate.
  36.         5.  Send ATB1(cr) to lock the modem at the new rate.
  37.         6.  Send ATO(cr) to the modem to return it to "online" mode.
  38.         7.  Exit leaving the fossil "hot" & locked at the new rate.
  39.  
  40. Hardware Compatibility
  41. ----------------------
  42.    RELOCK is designed for use with U.S. Robotics(tm) HST modems.  If your
  43. modem is not an HST it must conform to the following to be compatible with
  44. RELOCK:
  45.         1.  Escape sequence +++ must return the modem to "command" mode
  46.             without dropping carrier.
  47.         2.  ATB1 must be the command to lock your modem's baud rate.
  48.         3.  ATO must be the command to return your modem to "online" mode.
  49.         4.  Your modem must be able to accept commands at other than its
  50.             currently locked bps rate.
  51.  
  52.  
  53. Installing RELOCK
  54. -----------------
  55.    1. Set DIP switch 9 on your HST for "No disconnect on +++".
  56.    2. Insure that HST register S2 equals 43 (ASCII "+").
  57.    3. Make certain that X00's companion program XU is located
  58.       in your DOS search path.
  59.    4. Place RELOCK in your mailer or BBS batch file at a point where it
  60.       will be invoked after your mailer exits but before the BBS software
  61.       is loaded. (run RELOCK from the directory where it resides).
  62.  
  63.    BBS users will see "+++" on their screen as RELOCK executes.  You may
  64. wish to place a statement like "Adjusting communications speed. Stand by."
  65. in your mailer's "loading bbs" text message.
  66.  
  67.    RELOCK tests for the presence of a carrier upon entry and immediately
  68. after sending the +++ escape sequence.  The latter is done in case you
  69. have not set DIP switch 9 on your HST correctly.  If carrier is lost,
  70. RELOCK displays a message and exits.  It will not "hang" your batch file.
  71. RELOCK also displays several progress, error, and warning messages during
  72. execution as conditions warrant.
  73.  
  74. Command Line Parameters
  75. -----------------------
  76.    Typing RELOCK with no parameters will display a help screen.
  77.  
  78.    Syntax is: RELOCK fossil port bps1 bps2
  79.  
  80.         fossil = X00 or XOO for the X00 fossil. Others NOT supported.
  81.         port = 0 for COM1, 1 for COM2, 2 for COM3 or 3 for COM4
  82.         bps1 = modem's current locked bps rate (300 to 57600 bps)
  83.         bps2 = bps rate modem should be changed to (300 to 57600 bps)
  84.  
  85.    All four parameters are required.  An incorrect specification will
  86. cause an error message and the RELOCK help screen to be displayed followed
  87. immediately by program exit.  During installation debugging, it might be
  88. wise to place a PAUSE statement in your .BAT file immediately following
  89. the RELOCK statement.
  90.  
  91.    If bps2 is greater than bps1, RELOCK will display a warning message and
  92. proceed to re-lock the modem at the higher rate.  The warning is included
  93. merely because the normal use for RELOCK is to slow down rather than speed
  94. up the modem's locked rate.
  95.  
  96. EXAMPLE1:
  97.    RELOCK X00 0 57600 19200
  98.         Using  port 0 (COM1).  Modem is currently locked at
  99. 57,600 bps.  Relock it at 19,200 bps.
  100.  
  101. EXAMPLE2:
  102.    RELOCK XOO 1 38400 19200
  103.         Using port 1 (COM2).  Modem is currently locked at
  104. 38,400 bps.  Relock it at 19,200 bps.
  105.  
  106.  
  107. Support
  108. -------
  109.    If you have problems with RELOCK, you may contact the author by calling
  110. the LANStar BBS at 417-673-BAUD (2283) or by e-mailing Tim Pearson at
  111. 1:286/703 @ fidonet.  The most recent version of RELOCK will be available
  112. for download or file request at the same number/address.
  113.  
  114. The Shareware Concept
  115. ---------------------
  116.    Users of this program are free to evaluate it for a period of 30
  117. days at no charge.  After said evaluation period, you must discontinue
  118. its use or to send $10.00 US funds to:
  119.  
  120.         Timothy Pearson
  121.         110 West Main Street
  122.         Carterville, MO  USA  64835
  123.  
  124. Upon registration, you will receive a key file good for this and all future
  125. versions of RELOCK.  Registration will also eliminate the 10 second non-
  126. registered delay.
  127.  
  128. See RELOCK.REG contained in the RELOCK archive for more information.
  129.